Skip to content

feat: enhance CLI help messages with comprehensive documentation#19

Merged
inureyes merged 1 commit into
mainfrom
feature/more-detailed-help
Aug 27, 2025
Merged

feat: enhance CLI help messages with comprehensive documentation#19
inureyes merged 1 commit into
mainfrom
feature/more-detailed-help

Conversation

@inureyes
Copy link
Copy Markdown
Member

Summary

Enhanced all CLI help messages to provide comprehensive documentation directly in the terminal, matching the detail level of the manpage documentation.

Changes

  • Added detailed long descriptions for main command and all subcommands
  • Included practical examples for every command in after_help sections
  • Enhanced option descriptions with format specifications and usage details
  • Added special commands documentation for interactive mode
  • Documented authentication fallback chain and Backend.AI auto-detection
  • Clarified SFTP requirements and glob pattern support for file transfers
  • Explained output file structure and naming conventions

Impact

Users now have access to complete usage information directly from --help without needing to refer to external documentation. This significantly improves the user experience and makes the tool more self-documenting.

Test Results

All help messages have been tested and render correctly:

  • Main command help shows examples and comprehensive description
  • Subcommand help includes long descriptions and usage examples
  • Option descriptions provide detailed format specifications
  • Interactive mode documents all special commands

@inureyes inureyes added the type:enhancement New feature or request label Aug 27, 2025
@inureyes inureyes self-assigned this Aug 27, 2025
@inureyes inureyes merged commit bff856d into main Aug 27, 2025
3 checks passed
inureyes added a commit that referenced this pull request Aug 27, 2025
inureyes added a commit that referenced this pull request Aug 27, 2025
* fix: use parallel config value from configuration file

Previously, the parallel setting in config files was completely ignored.
This fix implements proper config support for the parallel option:

- Add get_parallel() method to Config struct (follows same pattern as get_timeout)
- Add parallel field to ClusterDefaults struct
- Check if user explicitly specified -p/--parallel in CLI args
- Use config value when CLI option not explicitly provided
- Priority: CLI (if explicit) > Cluster config > Global defaults > CLI default (10)

Now users can set parallel in their config files:
  defaults:
    parallel: 50
  clusters:
    production:
      parallel: 100

Fixes the issue where config parallel values were defined but never used.

* chore: prepare release v0.5.4

* update: help documents (#19)
@inureyes inureyes added priority:low Low priority issue status:done Completed type:docs Improvements or additions to documentation labels Sep 9, 2025
@inureyes inureyes deleted the feature/more-detailed-help branch October 30, 2025 01:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

priority:low Low priority issue status:done Completed type:docs Improvements or additions to documentation type:enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant